bpmn.governance.processes.{processInstanceId}.changeState
高级流程状态变更接口(支持并行节点跳转、子流程穿梭等各种流程状态变更能力)
- 请求路由:
bpmn.governance.processes.{processInstanceId}.changeState- 交互模型:
Request Response- 访问限制: 无
请求
RSocket.rr({
"route" : "bpmn.governance.processes.f364372d-393f-11f1-87ba-26ea39238720.changeState",
"args" : {
"request" : {
"activityName" : "确认开船",
"processVariables" : {
"governanceReason" : "管理员强行回退测试",
"siCutoff" : "2026-04-12T00:00:00.000+08:00"
}
}
}
});
请求参数
| 名称 | 类型 | 必须 | 说明 |
|---|---|---|---|
processInstanceId | String | 是 | 流程实例 ID |
request | Object | 否 | 变更请求 payload |
request.activityName | String | 否 | 快捷跳转设定:目标活动的名称(如“部门经理审批”) 设置此字段后,引擎会自动查出该流程实例当前的全部活跃节点,并统一跳转至翻译后的对应节点。 |
request.activityId | String | 否 | 快捷跳转设定:目标活动的节点ID(即 BPMN XML 中定义的 id,如“usertask1”) 设置此字段后,引擎会自动查找该流程实例当前的全部活跃节点,并统一跳转至该 ID 的节点。 |
request.taskVariables | Object | 否 | 快捷跳转设定:快捷全局任务局部变量 直接配合 activityName / activityId 使用,为其指定的最终汇聚目标任务注入 Local 变量,无需再拼装局部的映射。 |
request.moveActivityIds | Object[] | 否 | 单节点到单节点的细粒度状态跳转集合 |
request.moveActivityIds.[].currentActivityId | String | 否 | 原活动节点的 ID |
request.moveActivityIds.[].currentActivityName | String | 否 | 原活动节点的名称(如“初审”),将自动反查替换成ID |
request.moveActivityIds.[].newActivityId | String | 否 | 目标活动节点的 ID |
request.moveActivityIds.[].newActivityName | String | 否 | 目标活动节点的名称(如“复审”),将自动反查替换成ID |
request.moveActivityIdsToSingle | Object[] | 否 | 多节点汇聚到单节点的状态跳转集合 |
request.moveActivityIdsToSingle.[].currentActivityIds | String[] | 否 | 待跳转的当前多个原节点 ID 列表 |
request.moveActivityIdsToSingle.[].currentActivityNames | String[] | 否 | 待跳转的当前多个原节点名称列表 |
request.moveActivityIdsToSingle.[].newActivityId | String | 否 | 汇聚到的目标中心节点 ID |
request.moveActivityIdsToSingle.[].newActivityName | String | 否 | 汇聚到的目标中心节点名称 |
request.moveSingleToActivityIds | Object[] | 否 | 单节点拆分到多并行节点的状态跳转集合 |
request.moveSingleToActivityIds.[].currentActivityId | String | 否 | 分叉源头的当前节点 ID |
request.moveSingleToActivityIds.[].currentActivityName | String | 否 | 分叉源 头的当前节点名称 |
request.moveSingleToActivityIds.[].newActivityIds | String[] | 否 | 拆分指向的目标多个并行节点 ID 列表 |
request.moveSingleToActivityIds.[].newActivityNames | String[] | 否 | 拆分指向的目标多个并行节点名称列表 |
request.moveActivityIdToParent | Object[] | 否 | 终止子流程执行并跳转返回至父流程的指定节点的状态跳转集合 |
request.moveActivityIdToParent.[].currentActivityId | String | 否 | 原活动节点的 ID |
request.moveActivityIdToParent.[].currentActivityName | String | 否 | 原活动节点的名称(如“初审”),将自动反查替换成ID |
request.moveActivityIdToParent.[].newActivityId | String | 否 | 目标活动节点的 ID |
request.moveActivityIdToParent.[].newActivityName | String | 否 | 目标活动节点的名称(如“复审”),将自动反查替换成ID |
request.moveActivityIdToSubProcess | Object[] | 否 | 穿入到子流程内部的指定节点的状态跳转集合 |
request.moveActivityIdToSubProcess.[].currentActivityId | String | 否 | 当前处于主流程或外部流程的原节点 ID |
request.moveActivityIdToSubProcess.[].currentActivityName | String | 否 | 当前处于主流程或外部流程的原节点名称 |
request.moveActivityIdToSubProcess.[].newActivityId | String | 否 | 想要穿入到的子流程内部目标节点 ID |
request.moveActivityIdToSubProcess.[].newActivityName | String | 否 | 想要穿入到的子流程内部目标节点名称 |
request.moveActivityIdToSubProcess.[].callActivityId | String | 否 | 调用的外部子流程的活动元素 ID(CallActivity ID) |
request.moveActivityIdToSubProcess.[].subProcessDefinitionVersion | Number | 否 | 可选:指定的子流程定义版本号。为空则使用最新版 |
request.moveExecutionIds | Object[] | 否 | 基于执行实体(Execution)的单对单跳转集合 |
request.moveExecutionIds.[].executionId | String | 否 | 要直接操作移转的当前执行分支实体 ID(Execution ID) |
request.moveExecutionIds.[].newActivityId | String | 否 | 目标降落节点的 ID |
request.moveExecutionIds.[].newActivityName | String | 否 | 目标降落节点的名称 |
request.moveExecutionIdsToSingle | Object[] | 否 | 基于执行实体(Execution)的多对单重定向汇聚集合 |
request.moveExecutionIdsToSingle.[].executionIds | String[] | 否 | 多条流水线/执行实体的 ID 列表 |
request.moveExecutionIdsToSingle.[].newActivityId | String | 否 | 数据集中汇聚指向的新节点 ID |
request.moveExecutionIdsToSingle.[].newActivityName | String | 否 | 数据集中汇聚指向的新节点名称 |
request.moveSingleExecutionToActivityIds | Object[] | 否 | 基于执行实体(Execution)的单对多拆分跳转集合 |
request.moveSingleExecutionToActivityIds.[].executionId | String | 否 | 想要拆分的原本执行实体的 ID (Execution ID) |
request.moveSingleExecutionToActivityIds.[].newActivityIds | String[] | 否 | 拆分新生的多个目标节点 ID 列表 |
request.moveSingleExecutionToActivityIds.[].newActivityNames | String[] | 否 | 拆分新生的多个目标节点名称列表 |
request.processVariables | Object | 否 | 用于在跳转时向整个流程实例注入或覆盖的全局变量 |
request.localVariables | Object | 否 | 用于在跳转时为特定的任务(key为 taskName)注入或覆盖的局部任务级变量 |
返回
是否成功
true